Skip to content

feat(PhyslibAlpha): conserve energy and axial angular momentum along central-force trajectories - #2097

Merged
jstoobysmith merged 1 commit into
leanprover-community:masterfrom
hkjtsgmc79-boop:codex/central-force-conservation
Nov 16, 2026
Merged

jstoobysmith merged 1 commit into
leanprover-community:masterfrom
hkjtsgmc79-boop:codex/central-force-conservation

Conversation

@hkjtsgmc79-boop

Copy link
Copy Markdown
Contributor

Summary

This adds one lemma to the existing
PhyslibAlpha/ClassicalMechanics/CentralForce/AngularMomentum.lean and documents it as
section D of that module. It upgrades the existing Poisson-bracket statements to conservation
along a trajectory: on a central-force trajectory away from the centre, the energy and the
signed axial angular momentum L_z agree at any two times. No new file or definition is
introduced; the only new import is Mathlib's mean-value theorem.

Main result

CentralForce.hamiltonian_angularMomentumZ_eq_on_Icc: let S : CentralForce have positive
mass m and a radial potential V smooth on positive radii. For
p q : ℝ → EuclideanSpace ℝ (Fin 3), a b t₁ t₂ : ℝ, with t₁, t₂ ∈ Icc a b,
q t ≠ 0 for all t ∈ Icc a b, and Hamilton's equations

$$ \dot p(t) = -\frac{V'(|q(t)|)}{|q(t)|},q(t), \qquad \dot q(t) = m^{-1} p(t) $$

on Icc a b, one has

$$ H(p(t_1),q(t_1)) = H(p(t_2),q(t_2)), \qquad L_z(p(t_1),q(t_1)) = L_z(p(t_2),q(t_2)), $$

where H(p,q) = ‖p‖²/(2m) + V(‖q‖) and L_z(p,q) = q₀ p₁ - q₁ p₀.

Proof

For a phase-space function f that is differentiable at each phase-space point (p t, q t)
of the trajectory and satisfies {f,H} = 0 there, hasDerivAt_comp_eq_poissonBracket
identifies the time derivative of f(p(t),q(t)) with the Poisson bracket, so the derivative
vanishes. constant_of_has_deriv_right_zero then gives constancy on the interval. Energy
uses {H,H} = 0; L_z uses the existing poissonBracket_angularMomentumZ_hamiltonian,
whose hypothesis q t ≠ 0 is supplied by the trajectory assumption. The position and
momentum gradients are rewritten with hasGradientAt_hamiltonian_position and
hasGradientAt_hamiltonian_momentum; differentiability of H and L_z comes from
contDiffOn_hamiltonian and contDiff_angularMomentumZ.

Scope

Central force; finite time interval; trajectory away from the centre of force; Hamilton's
equations assumed on the interval. No global flow, existence/uniqueness, or time-dependent
Hamiltonian is claimed. Only energy and L_z are covered along the trajectory; L² remains at
the Poisson-bracket level. The new result is a lemma; no theorem is added.

Verification

  • The changed module compiles in the local worktree (direct lean invocation, no diagnostics).
  • module_doc_lint, noAlphaImports, alphaFileImports, runPhyslibAlphaLinters,
    theorem_lint, and lint-style.py on the changed file pass.
  • git diff --check is clean.
  • One file changed, +42/−0.
  • On Lean 4.35.0, lake build -KCI --iofail Physlib QuantumInfo PhyslibAlpha completed
    successfully (6337 jobs).
  • #print axioms ClassicalMechanics.CentralForce.hamiltonian_angularMomentumZ_eq_on_Icc
    reported only propext, Classical.choice, and Quot.sound.

References

The module's existing Goldstein reference (Section 9.7 and Chapter 3) covers the Poisson-bracket
and central-force background; no new bibliography entry is added.

AI assistance and authorship

The commit is authored by Qianli Ma and co-authored by Codex. The human author is responsible
for the statement and proof.

…rce trajectories

Co-authored-by: Codex <codex@openai.com>
@github-actions github-actions Bot added small PhyslibAlpha Pull requests which are for modifications to PhyslibAlpha. labels Nov 16, 2026
@github-actions

Copy link
Copy Markdown
Contributor

Thank you for this pull-request (PR). If this is your first PR, welcome to the community!

While you wait for a review, note that you can review PRs too; reviewing is not restricted to maintainers. Our review guidelines explain what to look for.

Over time, contributions such as reviews, maintenance and documentation are recorded on contributions.physlib.io.

Three main points:

  • Comment -awaiting-author on its own line to remove that label from your PR.
  • Comment blocked-by-PR or -blocked-by-PR on its own line to add or remove that label, respectively.
  • The first review might take several days to arrive. If in doubt message on the Zulip.

For the author: Please read

Below is what will happen next. Please read carefully if you are not familiar with the process. You may open other PRs while this one is being reviewed, and can stack PRs on top of each other, so don't let these steps slow you down.

  1. Some automated checks will be run on your PR. You can see the results of these checks at the buttom of your PR page. If any of these checks fail, you will need to fix the issues before your PR can be merged. You can learn more about these here, including how to run them locally, which is sometimes quicker than relying on the GitHub Actions. If you have never had a PR merged before, you may have to wait for a reviewer to manually start these checks (this is for security).

  2. A reviewer will look at your PR and may ask you to make changes. This may happen a couple of days after you submit your PR, so you may need to be patient. But it should not be longer than that - if it is please bring it to the attention of the community on the Zulip. The level of review will depend on where your PR is submitted. If it is submitted to ./Physlib or ./QuantumInfo, the review will be more thorough than if it is submitted to ./PhyslibAlpha. You can find out more about what the review process is looking for in our review guidelines. If a reviewer adds an awaiting-author label to your PR, address the review comments, then please remove that label by adding a comment with -awaiting-author. This helps us keep track of reviews.

  3. The reviewer will either approve your PR, or request more changes (in which case we return to step 2). Once your PR is approved, it will be merged by a maintainer, this should happen shortly after approval, though you may get more comments at this stage.

Tip: The easiest way to get a fast review is to submit a PR that is small and self-contained, and has clear documentation explaining why things are the way they are in your changes.

If you have any problems or questions, please reach out to the community on the Zulip.

For reviewers: Summary of your PR

Found differences:
@@ PhyslibAlpha.ClassicalMechanics.CentralForce.AngularMomentum @@
! module modified PhyslibAlpha.ClassicalMechanics.CentralForce.AngularMomentum (+42 -0)
  namespaces ClassicalMechanics, ClassicalMechanics.CentralForce
+ added lemma hamiltonian_angularMomentumZ_eq_on_Icc
2 differences

The declarations are found by reading the diff as text, without regard for namespaces, so a declaration whose keyword and name are on different lines is missed, and two declarations of the same name in different namespaces are listed as one. A change to a proof, or to the body of a definition, does not appear. See scripts/alpha/github/pr_summary.lean.

Summary of commit e61a10c, remade whenever a commit is pushed.

@jstoobysmith jstoobysmith left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Approved - will merge now.

@jstoobysmith jstoobysmith added the ready-to-merge This PR is approved and will be merged shortly label Nov 16, 2026
@jstoobysmith
jstoobysmith added this pull request to the merge queue Nov 16, 2026
Merged via the queue into leanprover-community:master with commit be0a9ee Nov 16, 2026
11 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

PhyslibAlpha Pull requests which are for modifications to PhyslibAlpha. ready-to-merge This PR is approved and will be merged shortly small

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants